home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / bib.man < prev    next >
Encoding:
Text File  |  1989-05-17  |  5.1 KB  |  199 lines
  1.  
  2.  
  3.  
  4. BIB                       User Commands                       BIB
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      bib, listrefs - bibliographic formatter; list bibliographic
  10.      reference items
  11.  
  12. SSYYNNOOPPSSIISS
  13.      bbiibb [options] ...
  14.      lliissttrreeffss [options] ...
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      _B_i_b is a preprocessor for _n_r_o_f_f or _t_r_o_f_f(1) that formats
  18.      citations and bibliographies.  The input files (standard
  19.      input default) are copied to the standard output, except for
  20.      text between [. and .] pairs, which are assumed to be key-
  21.      words for searching a bibliographic database.  If a matching
  22.      reference is found a citation is generated replacing the
  23.      text.  References are collected, optionally sorted, and
  24.      written out at a location specified by the user.  Citation
  25.      and reference formats are controlled by the -t option.
  26.  
  27.      Reference databases are created using the _i_n_v_e_r_t utility.
  28.  
  29.      The following options are available.  Note that standard
  30.      format styles (see the -t option) set options automatically.
  31.      Thus if a standard format style is used the user need not
  32.      indicate any further options for most documents.
  33.  
  34.      -aa     reduce authors first names to abbreviations.
  35.  
  36.      -ar_n_u_m  reverse the first _n_u_m author's names.  If a number
  37.              is not given all authors names are reversed.
  38.  
  39.      -ax     print authors last names in Caps-Small Caps style.
  40.              For example Budd becomes BUDD.  This style is used
  41.              by certain ACM publications.
  42.  
  43.      -c_s_t_r   build citations according to the template _s_t_r.  See
  44.              the reference format designers guide for more infor-
  45.              mation on templates.
  46.  
  47.      -ea     reduce editors first names to abbreviations.
  48.  
  49.      -ex     print editors last names in Caps-Small Caps style
  50.              (see -ax option).
  51.  
  52.      -er_n_u_m  reverse the first _n_u_m editors names.  If a number is
  53.              not given all editors names are reversed.
  54.  
  55.      -f      instead of collecting references, dump each refer-
  56.              ence immediately following the line on which the
  57.              citation is placed (used for footnoted references).
  58.  
  59.      -i _f_i_l_e
  60.  
  61.  
  62.  
  63. Univ of Arizona           May 25, 1986                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. BIB                       User Commands                       BIB
  71.  
  72.  
  73.  
  74.      -i_f_i_l_e  process the indicated file, such as a file of defin-
  75.              itions.  (see technical report for a description of
  76.              file format).
  77.  
  78.      -h      replace citations to three or more adjacent refer-
  79.              ence items with a hyphenated string (eg 2,3,4,5
  80.              becomes 2-5).  This option implies the -o option.
  81.  
  82.      -n_s_t_r   turn off indicated options.  _s_t_r must be composed of
  83.              the letters afhosx.
  84.  
  85.      -o      contiguous citations are ordered according the the
  86.              reference list before being printed (default).
  87.  
  88.      -p _f_i_l_e
  89.  
  90.      -p_f_i_l_e  instead of searching the file INDEX, search the
  91.              indicated reference files before searching the sys-
  92.              tem file.  _f_i_l_e_s is a comma separated list of
  93.              inverted indices, created using the _i_n_v_e_r_t utility.
  94.  
  95.      -s_s_t_r   sort references according to the template _s_t_r.
  96.  
  97.      -t _t_y_p_e
  98.  
  99.      -t_t_y_p_e  use the standard macros and switch settings for the
  100.              indicated style to generate citations and refer-
  101.              ences.  There are a number of standard styles pro-
  102.              vided.  In addition users can generate their own
  103.              style macros.  See the format designers guide for
  104.              details.
  105.  
  106.      _L_i_s_t_r_e_f_s formats an entire reference database file.  Options
  107.      to _l_i_s_t_r_e_f_s are the same as for _b_i_b.
  108.  
  109.      _B_i_b was designed initially for use with the -ms macros, and
  110.      uses a couple of the -ms macros (.ip and .lp) in its macro
  111.      definitions.  To use it with the -me macros, prefix the file
  112.      being sent to nroff/troff with the following macro defini-
  113.      tions:
  114.                .de IP
  115.                .ip \$1 \$2
  116.                ..
  117.                .de LP
  118.                .lp
  119.                ..
  120.  
  121.      A file "bibmac.me" containing these macro definitions may be
  122.      found in /usr/new/lib/bmac.
  123.  
  124. FFIILLEESS
  125.      INDEX               inverted index for reference database
  126.  
  127.  
  128.  
  129. Univ of Arizona           May 25, 1986                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. BIB                       User Commands                       BIB
  137.  
  138.  
  139.  
  140.      /usr/dict/papers/INDEXdefault system index
  141.      /usr/new/lib/bmac/bmac.*formatting macro packages
  142.      /usr/tmp/bibr*      scratch file for collecting references
  143.      /usr/tmp/bibp*      output of pass one of bib
  144.  
  145. SSEEEE AALLSSOO
  146.      _A _U_N_I_X _B_i_b_l_i_o_g_r_a_p_h_i_c _D_a_t_a_b_a_s_e _F_a_c_i_l_i_t_y, Timothy A. Budd and
  147.      Gary M. Levin, University of Arizona Technical Report 82-1,
  148.      1982.  (includes format designers guide).
  149.      invert(1), troff(1)
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Univ of Arizona           May 25, 1986                          3
  196.  
  197.  
  198.  
  199.